home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / storex44.zip / STOREX.DOC < prev    next >
Text File  |  1992-11-07  |  17KB  |  356 lines
  1.  
  2.                                  LIVESTORE 4.4
  3.  
  4.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  5.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  6.                     Remote Access, SpitFire, WWIV and others.
  7.  
  8.                                       By
  9.                                 Richard Paquette
  10.                                    PO Box 416
  11.                               Mt. Laurel, NJ 08054
  12.  
  13.                                (C) Copyright 1992
  14.                                All Rights Reserved
  15.  
  16.                                 DOOR DESCRIPTION!
  17.  
  18. This door allows the sysop to establish a shopping center environment
  19. for his/her bbs. This door will allow up to 54 Departments when registered and
  20. only 3 while being used for evaluation purposes.
  21.  
  22. The first screen to be seen (if exist) is a welcome screen, this MUST
  23. be called STOREX.SCR. It can be edited with most any ansi/ascii program. If
  24. you use THEDRAW, please save it with a ALT-B option at maximum 18 lines. It
  25. will display much faster and complete this way. Other programs we aren't sure
  26. about.. let us know!
  27.  
  28. The next screen shown will be the Main Department Selection Screen, if
  29. you have more than 27 departments, there will be a prompt such as:
  30.  
  31.                  FIRST FLOOR [CR] = Second Floor Departments
  32.                   " Press ENTER to continue or E to exit "
  33.  
  34. If they hit [CR] then the next floor will be displayed in much the
  35. same way saying:
  36.  
  37.         SECOND FLOOR [CR] = First Floor Departments
  38.     
  39. But on this floor they will be prompted for the department they wish
  40. to visit. If a [CR] is hit, then they will be brought back to the FIRST FLOOR
  41. automatically at which time the first prompt will be shown again, if they hit
  42. E to exit, then they will be prompted for the department they wish to visit.
  43.  
  44. If they enter a department number above your last department, they will
  45. be told "NO SUCH DEPARTMENT" and the prompt will return. If they select any
  46. department and LIVESTORE CANNOT find the display file, they will be prompted
  47.  "File not found, Please notify your Sysop!". Hopefully, they will leave you
  48. a comment so that the problem can be fixed.
  49.  
  50. When viewing a department screen, the prompt bar will have always have
  51. the following options:
  52.  
  53.       [O]=Order  [S]=Search  [M]=Menu  [Q]=Quit to BBS  [CR]=Continue
  54.  
  55. If the O option is selected, they will be prompted for all the info-
  56. mation we need to create an order file for you called (orders.yes) in the
  57. program directory. At almost every prompt, they have the option to [Q] the
  58. order.. this WILL NOT write and orders.yes file. They will simply be brought
  59. back to the Main Department Menu.
  60.  
  61. If they select the S option, they will be prompted whether they would
  62. like it displayed [1]=One line at the time or [2]=Full page display. Then they
  63. are prompted for the "keyword" to search.. if none is found, they are brought
  64. back to the Main Department Menu. Of course if the "keyword" is found, it will
  65. be displayed in whichever manner they selected. (I hope)
  66.  
  67. If they select the M option, they are brought back to the Main Menu.
  68.  
  69. If they select the Q option, they are brought back to the BBS Menu.
  70.  
  71. If they hit [CR] then the department file continues to display with
  72. the prompt line always there giving them all the options at any time.
  73.  
  74. Well, that is about it for the screens. Of course if any of the files
  75. needed for display in a department aren't there.. then they will have a hard
  76. time to order anything! <GR>
  77.  
  78. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  79.  
  80.                   Supports COM 1 to 4 on the standard IRQ's
  81.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  82.  
  83.                You can make use of the IRQ environment variable
  84.  
  85. If you wish to use a non-standard IRQ, add the IRQ number after the 
  86. configuration filename. For example the program is STOREX and you want to use 
  87. Com1 and IRQ5. The command line passed to your door would be:
  88.  
  89.                           STOREX STOREX.CFG /5 
  90.  
  91.                                   or
  92.  
  93.           STOREX STOREX.CFG /%IRQ% using the environment variable
  94.  
  95. The /5 tells STOREX to use IRQ5 rather than the standard IRQ4 that is
  96. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  97.  
  98. IMPORTANT NOTE FOR DIGIBOARD USERS:
  99.  
  100.  LiveStore now includes support for FOSSIL drivers!!! This means your Doors
  101.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  102.  boards. To activate the Fossil driver support, just include /FD on the
  103.  command line when running the Door. For example:
  104.  
  105.       STOREX STOREX.CFG /FD
  106.  
  107.  If no Fossil driver is available, LiveStore will display a message to that
  108.  effect and exit gracefully.
  109.  
  110.                                  FILES
  111.  
  112.              The following files are packaged with STOREX40.ZIP
  113.  
  114.  Storex.exe   <--- executable program (MUST BE IN DIRECTORY)
  115.  Storex.cfg   <--- sample configuration file (MUST BE IN DIRECTORY)
  116.  Storex.ndx   <--- file names for each department (MUST BE IN DIRECTORY)
  117.  Storex.doc   <--- You are reading it right now
  118.  Storex.new   <--- explains whatsnew with each version
  119.      *x.txt   <--- All the same files renamed for Samples ONLY!
  120.  Storex.scr   <--- Welcome screen that MUST be remain named STOREX.SCR
  121.  Strutil.exe  <--- Utility to create txt files
  122.  Strutil.doc  <--- Docs for Strutil.exe program
  123.  Storex.log * <--- program will create and append with each visitor
  124.  Storex.ord * <--- created when an order is placed from any department
  125.                   and appended if not deleted.
  126.  
  127.                    EXPLANATION OF STOREX.CFG FILE NEEDED
  128.  
  129.     %PCBDRIVE%%PCBDIR%\USERS.SYS <-- Using environment variables for path
  130.     The Livewire BBS             <-- Your BBS Name
  131.     Richard                      <-- Your First Name
  132.     Paquette                     <-- Your Last Name
  133.     99999                        <-- Registration # (something MUST be here)
  134.     Callers Digest, Inc.         <-- Your company or BBS name displayed on Menu
  135.     YES                          <-- Allow shipping prompts (YES or NO)
  136.     YES                          <-- Accept Credit Cards (YES or NO)
  137.     VMDA                         <-- Visa, Mastercard, Discover, American Ex
  138.     NJ625  (Means 6.25% etc.)    <-- Your STATE and your STATE TAX
  139.     9                            <-- Number of Departments (SEE NOTE BELOW)
  140.     Add-On Cards                 <-- Name of department (20 character MAX)
  141.     USR Modems                   <-- Name of department 
  142.     VGA Monitors                 <-- Name of department
  143.     Artisoft Lantastic           <-- Name of department
  144.     Mother-Boards                <-- Name of department
  145.     Keyboards                    <-- Name of department
  146.     Entire Systems               <-- Name of department
  147.     Floppy Drives                <-- Name of department
  148.     Hard Drives                  <-- Name of department
  149.         
  150. NOTE: If you are haven't registered LIVESTORE, then any number you
  151. enter here over 3 will NOT be displayed.. an UNREGISTERED version can only
  152. handle 3 departments.. so it will overlook any department names after the
  153. third one!
  154.  
  155.                    EXPLANATION OF STOREX.NDX FILE NEEDED
  156.     
  157. EACH of these files MUST be made up by YOU.. We have no outlets for 
  158. any products whatsoever. The products and txt file to display are all your
  159. responsibility. PLEASE do not call us for products or text files.. we have
  160. none.. the text files shown in our copy of STOREX on The Livewire BBS are for
  161. display sample ONLY!
  162.  
  163.     systemsx.txt   <-- sample random file created with strutil.exe
  164.     monix.txt      <-- sample also
  165.     modemx.txt     <-- sample also
  166.     
  167.            NOTE: these files MUST BE in the same directory
  168.                  that the door is being run from, for example:
  169.                  if you have c:\pcb\storex then all go in storex dir.
  170.  
  171. If you have any other suggestions to improve this program and/or have
  172. problems, please call us at THE LIVEWIRE BBS (number at bottom) and leave us
  173. a C)omment explaining in detail what happened, leave us a voice number and we
  174. will be glad to call you back to help with the setup and/or fix the problem.
  175.  
  176. The following are examples for the first FOUR lines only, you must
  177. read the above for the proper configuration file after the top FOUR lines!
  178.  
  179.         EXAMPLE CONFIGURATION FILE FOR NEW WILDCAT 3.0
  180.         ------------------------------------------
  181.  
  182.         C:\CAT\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  183.         The Livewire BBS    <=-  (Change this to your BBS name)
  184.         Richard             <=-  (The Sysop's first name)
  185.         Paquette            <=-  (The Sysop's last name)
  186.  
  187.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  188.         ---------------------------------------
  189.  
  190.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  191.         The Livewire BBS    <=-  (Change this to your BBS name)
  192.         Richard             <=-  (The Sysop's first name)
  193.         Paquette            <=-  (The Sysop's last name)
  194.  
  195.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  196.         -------------------------------------------
  197.  
  198.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  199.         The Livewire BBS    <=-  (Change this to your BBS name)
  200.         Richard             <=-  (The Sysop's first name)
  201.         Paquette            <=-  (The Sysop's last name)
  202.  
  203.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  204.         -------------------------------------------
  205.  
  206.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  207.                                   where 'x' is the BBS Node number.
  208.         The Livewire BBS    <=-  (Change this to your BBS name)
  209.         Richard             <=-  (The Sysop's first name)
  210.         Paquette            <=-  (The Sysop's last name)
  211.  
  212.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  213.         ------------------------------------------
  214.  
  215.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  216.         The Livewire BBS    <=-  (Change this to your BBS name)
  217.         Richard             <=-  (The Sysop's first name)
  218.         Paquette            <=-  (The Sysop's last name)
  219.  
  220.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  221.         ----------------------------------------
  222.  
  223.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  224.         The Livewire BBS    <=-  (Change this to your BBS name)
  225.         Richard             <=-  (The Sysop's first name)
  226.         Paquette            <=-  (The Sysop's last name)
  227.  
  228.                                  ==============
  229.  
  230.                                 STOREX BATCH FILE
  231.  
  232. This is the batch file whose name is entered in your SETUP. It should reside in
  233. your default directory. Leave this as is except for changing the paths.
  234.  
  235.   @ECHO OFF          <-- optional
  236.   E:\                <-- start batch at root directory of door directory
  237.   CD\STOREX          <-- change to door directory
  238.   SET PCBDRIVE=C:    <-- for NON PCBoard BBS's where your system dir is
  239.   SET PCBDIR =\BBS   <-- for NON PCBoard BBS's where your system files are
  240.   STOREX STOREX.CFG  <-- Please read NOTE below
  241.   SET PCBDRIVE=      <-- Set variable to NULL
  242.   SET PCBDIR=        <-- Set variable to NULL
  243.   C:\                <-- return to root
  244.   CD\BBS             <-- change to your bbs dir
  245.   BOARD              <-- run bbs file
  246.  
  247.   NOTE: By using the environment variables you need ONLY ONE CFG for each
  248.         node and saves from editing many CFG files. Our STRUTIL.EXE program
  249.         will default to editing the STOREX.CFG file anyway.. so you would
  250.         then need to rename each if you wanted to use many CFG files. We
  251.         strongly suggest using environment variables to ease operation.
  252.  
  253.   NOTE: There is NO need for seperate configuration files for each
  254.         node.. you can use the same STOREX.CFG for each node batch
  255.         file. If you have problems, please notify us as soon as you
  256.         can with copies of your batch file and config file.
  257.  
  258.                      ------------------------------------
  259.  
  260.                                 DOOR OPERATION
  261.                                 --------------
  262.   
  263.   F3    -   Toggles the printer On/Off.
  264.             Value is passed to PCBoard.
  265.   F4    -   Toggles the Page Bell On/Off.
  266.             Value is passed to PCBoard.
  267.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  268.   F7    -   Toggles the Caller Alarm On/Off.
  269.             Value is passed to PCBoard.
  270.   F8    -   Returns the caller involuntarily to PCBoard.
  271.             Without letting them know that the sysop called them back!
  272.   F9    -   Toggles the local display On/Off.
  273.             Value is passed to PCBoard.
  274.   F10   -   Activates SysOp CHAT mode within the DOOR.
  275.  
  276.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  277.   HOME  -   HELP key for status line options.
  278.   UP    -   Allows the SysOp to temporarily give the caller extra time
  279.             while in the DOOR.  This time is NOT passed to PCBoard.
  280.   DN    -   Allows the SysOp to temporarily subtract time from the
  281.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  282.   ALT-N -   SysOp next on toggle.
  283.             Value is passed to PCBoard.
  284.   ALT-X -   PCBoard will exit after current caller logs off.
  285.             Value is passed to PCBoard.
  286.  
  287.                             WATCHDOG/CTTY/ANSI.SYS
  288.                             ----------------------
  289.  
  290.         CTTY and WATCHDOG are NOT required and should not be used with
  291.         this program.  STOREX contains its own communication routines
  292.         which monitor the COM port.  If carrier is lost, it will return
  293.         to the BBS where the BBS will log the user off the system.
  294.  
  295.         ANSI.SYS or something similar, is required for STOREX to function.
  296.  
  297.                                  DISTRIBUTION
  298.                                  ------------
  299.  
  300.         STOREX is COPYRIGHTED by Richard Paquette, with all rights reserved.
  301.         This program is being distributed via the SHAREWARE concept and as
  302.         such, may be copied freely with the following restrictions:
  303.  
  304.                 * The program must be supplied in it's original
  305.                   unmodified form, including documentation.
  306.  
  307.                 * STOREX may not be distributed as part of any
  308.                   commercial application or service without the
  309.                   express, written consent of the author.
  310.  
  311.                 * Vendors of Shareware/Public Domain software may
  312.                   not distribute this program without the express,
  313.                   written consent of the author.
  314.  
  315.                                  REGISTRATION
  316.                                  ------------
  317.  
  318.         STOREX represents many hours of programming and the author
  319.         deserves just compensation for his time, efforts and expertise.
  320.         If you find this program to be of some value and you continue
  321.         to use it on your BBS system, you must return the registration
  322.         form provided along with the registration fee. Registration
  323.         entitles you to free upgrades via modem from The Livewire's Support
  324.  
  325.            **********           REGISTER ONLINE          ***********
  326.  
  327.         You may also call The Livewire BBS and register online via
  328.         Visa or Mastercard using our online Credit Card door which will 
  329.         produce your registration number on the spot! At the main board
  330.         prompt just type  REGISTER  and presto.. 
  331.  
  332.         Suggestions and/or comments may be sent to the address below or
  333.         via electronic mail: 
  334.  
  335.         The executable has been compressed using PKLite and if you have
  336.         any problems.. please call The Livewire BBS and download an exe
  337.         that hasn't been compressed with PKLite.. We have NOT had any
  338.         problems but wanted to notify you the exe is available in its
  339.         raw state! <GR>
  340.  
  341.                              NET-HUB for RealLife
  342.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  343.                   HUBNJ  for Intellec and Node ID is: LIVEWIRE
  344.                   HUBNJ  for AfterDrk and Node ID is: LIVEWIRE
  345.                   HUBNJ  for SmartNet and Node ID is: LIVEWIRE
  346.                   or on ILink with Node ID of LIVEWIRE.
  347.                           FidoNet Address:  1/266:36
  348.                         PoliceNet Address: 150/350:29
  349.                                 Richard Paquette
  350.                                 The Livewire BBS     
  351.  
  352.           Public Access Node1: (609) 235-5297 MNP/5 - 300/1200/2400
  353.           Access to all other Nodes after registering a door program
  354.                             ----------------------
  355.       High Speed access for Registrations ONLY 609-866-2551 USRobotics DS
  356.